Setting ePublisher AutoMap Preferences
The Preferences window lets you specify default options and preferences that affect the behavior of ePublisher AutoMap. These preferences allow you to customize the console for your specific needs.
Specifying the Job, Staging, and User Formats Folder Locations
ePublisher AutoMap has several folders where it stores job-related information, such as job files and log files. You can customize the location of these folders.
Job Folder
ePublisher AutoMap stores the following types of job-related files in the job folder:
log file
A text file that contains information about the last transformation process. ePublisher AutoMap creates the log file when you run the job. You can view the log file with any text editor.
job file
A proprietary XML formatted file that contains information describing the job. When you create a job, ePublisher AutoMap creates the job file and stores the information you specify in the console. The job file name is the name of the job with a .waj (WebWorks AutoMap Job) file extension.
Note: ePublisher AutoMap maintains the job files. Do not edit these files.
The default job folder is the Documents\ePublisher AutoMap\Jobs folder.
Staging Folder
ePublisher AutoMap stores information needed for transforming the source documents in the staging folder. This information includes the automatically generated ePublisher project, intermediate data files, and the output files. The staging folder provides a working folder for processing each job. ePublisher AutoMap then writes the final output files to the target output destination specified when the project was created.
Note: ePublisher AutoMap creates the files in the staging folder. Do not edit these files.
The default staging folder is the Documents\ePublisher AutoMap\Staging folder.
User Formats Folder
When ePublisher AutoMap processes a job, it searches the user formats folder for custom user formats. The default user formats folder is the Documents\ePublisher User Formats folder.
To specify the job, staging, and user formats folder locations
  1. Start ePublisher AutoMap.
  2. On the Edit menu, click Preferences.
  3. Click the General tab.
  4. In the Job Folder field, type the path to the folder or network share where you want ePublisher AutoMap to store the job and log files. You can click Browse and navigate to the folder or network share.
  5. In the Staging Folder field, type the path to the folder or network share where you want ePublisher AutoMap to store the job projects and output created during your transformations. You can click Browse and navigate to the folder or network share.
  6. In the User Formats Folder field, type the path to the folder or network share where ePublisher AutoMap checks for the custom user formats to use for creating jobs. You can click Browse and navigate to the folder or network share.
  7. Click OK to save your preferences.
Automatic Scanning for Conditions and Variables
When ePublisher AutoMap displays windows that list conditions and variables, you can specify whether ePublisher AutoMap automatically scans the source documents for updated conditions and variables. Since your source documents may not have new conditions or variables, ePublisher AutoMap attempts to save time by default and it does not automatically scan for new conditions and variables. You can click Scan Documents on a window to have ePublisher AutoMap scan your source documents and update the window contents.
If you want ePublisher AutoMap to always display updated condition and variable values, select the Always scan for variables and conditions option. Depending on the number and size of files included in the job, each scan may require several minutes before ePublisher AutoMap can display the conditions and variables windows.
To enable automatic scanning
  1. Start ePublisher AutoMap.
  2. On the Edit menu, click Preferences.
  3. On the General tab, select Always scan for variables and conditions.
  4. Click OK to save your preferences.
Keeping or Deleting Temporary Files
You can choose whether ePublisher AutoMap keeps or deletes the temporary files created in the staging folder when it runs a job. By default, ePublisher AutoMap does not delete these files. You need these files only if you want to examine the actual project and intermediate files created and used during the transformation process. If you do not want to examine these files, you can disable allow ePublisher AutoMap to delete the files and reduce the amount of disk space used.
To delete temporary files
  1. Start ePublisher AutoMap.
  2. On the Edit menu, click Preferences.
  3. On the General tab, select Delete temporary files after generating.
  4. Click OK to save your settings.
Defining File Mappings
ePublisher allows you to map files based on their file extension to a source document adapter that processes that input format. This capability provides the flexibility you need:
  • You can define which source application processes a file that can be handled by multiple source applications. For example, both Adobe FrameMaker and Microsoft Word can open text files with a .txt extension. The File Mappings tab allows you to choose which application to use for each file based on the file extension.
  • You can define custom file extensions. For example, you may choose to use a non-standard file extension for your Microsoft Word source documents, such as .word instead of .doc. The File Mappings tab allows you to add your custom file extension and map it to the appropriate source application adapter.
  • You can add new input formats as they become available. ePublisher provides a powerful framework in which Quadralay and their partners can develop new input formats, such as custom XML formats. Since XML is a common format, the source files are usually given unique and descriptive file extensions. The File Mappings window ensures that your projects are ready to handle any input sources.
Note: ePublisher AutoMap lists only the source application adapters installed with the product. Your Contract ID specifies the adapters for which you are licensed. adapter you want to use.
To modify your file mappings
  1. Start ePublisher AutoMap.
  2. On the Edit menu, click Preferences.
  3. Click the File Mappings tab.
  4. If you want to add a new file mapping, complete the following steps:
    1. Click Add.
    2. In File extension, type a file extension to be mapped.
    3. In Adapter, select one of the installed source adapters, and then click OK.
  5. If you want to modify an existing file mapping, in the Adapter column next to the file extension you want to modify, select the installed source adapter you want to use for files with that file extension.
  6. If you want to delete an existing file mapping, complete the following steps:
    1. In the File Extension column, select the file extension you want to delete.
    2. Click Delete.
  7. Click OK to save your preferences.
Defining Output Destinations
ePublisher AutoMap allows you to create and manage output locations independent of your jobs. This flexibility allows you to define your output locations and then select the one you want to use when you create a new job. You can also create a new output location as the final part of the job creation process. ePublisher AutoMap allows you to deploy the final output files to a folder on a local or shared file system, such as C:\helpdocs or \\server\share.
To define output destinations:
  1. If you use the ePublisher AutoMap user interface to schedule an ePublisher Express project, you must set the deployment destination in the ePublisher Express project. For more information, see Creating Output Destinations.
  2. If you use the ePublisher AutoMap CLI to run an ePublisher Express project, you can set the deployment destination in the ePublisher Express project or in the CLI. For more information, see Creating Output Destinations and Using the Command-Line Interface.
  3. If you use ePublisher AutoMap to schedule a Stationery project, you must set the deployment destination in the job settings, and you must set the deployment destination independently for each target. Specify the deployment destination in the job settings by completing the following steps:
    1. Start ePublisher AutoMap.
    2. Select the job to edit in the ePublisher AutoMap main window.
    3. On the Job menu, click Edit.
    4. Select the Target Configuration tab.
    5. In the left pane, select the target for which you want to set the output destination.
    6. On the Info tab, in the Deployment area, specify the deployment destination information.
    7. Click OK.
  4. If you use the CLI to run a Stationery project, you can set the deployment destination in the ePublisher AutoMap job settings or in the CLI. Set the deployment destination in the job settings by completing the following steps:
    1. Start ePublisher AutoMap.
    2. Select the job to edit in the ePublisher AutoMap main window.
    3. On the Job menu, click Edit.
    4. Select the Target Configuration tab.
    5. In the left pane, select the target for which you want to set the deployment destination.
    6. On the Info tab, in the Deployment area, specify the deployment destination information.
    7. Click OK.
      For more information about setting the deployment destination in the CLI, see Using the Command-Line Interface.
Defining Email Notifications
ePublisher AutoMap can send an email notification after running a job. The notification provides information about whether the job ran successfully or encountered any errors. You can also specify whether to include the log file as a text file attachment to the email.
To configure email notification
  1. Start ePublisher AutoMap.
  2. On the Edit menu, click Preferences.
  3. Click the Notification tab.
  4. Select Enable Email Notification.
  5. Specify the email addresses and email server information. For more information about a field, click Help.
  6. Click OK to save your preferences.
Note: You can quickly enable or disable email notification without modifying the other preferences by toggling the Enable email notification check box.
Selecting Console Language (English, German, French, and Japanese)
In addition to the English language, the ePublisher consoles have been translated into German, French, and Japanese languages. When ePublisher starts, it detects the operating system locale and displays the corresponding ePublisher console. You can display the console for a locale that is not the operating system default. For example, you can display the German console on an English version of Windows.
To select the language for the console
  1. Start your ePublisher console.
  2. On the Edit menu, click Preferences.
  3. In the User interface language field on the General tab, select the language you want the console to display.
  4. Click OK to save your preferences.
  5. Close and restart the console to view the console in the selected language.
Was this helpful?
Last modified date: 01/28/2026